WeatherTracker allows you to connect to an Internet weather server to get current weather information and forecasts for a specified city. It requires a 68020 or higher with System 7.0 and MacTCP or OpenTransport. WeatherTracker is shareware -- see the notice at the end of this document regarding payment.
What happened to MacWeather, NetWeather, and MacWx?
Previous versions were called MacWeather, but since Accu-Weather holds a registered trademark for MacWeather¿, so I changed the name to NetWeather. Shortly after changing to NetWeather, I was informed that AccuWeather also holds a trademark for netWeather¿. I then changed the name to MacWx, but they thought that was too close to MacWeather since WX is an abbreviation for weather. So far, there are no objections to WeatherTracker, so keep your fingers crossed.
What is MacTCP?
MacTCP is an extension that provides the Macintosh implementation of TCP/IP, a communications protocol which allows your computer to talk to other computers on the Internet. In order to use MacTCP, you must have some type of connection to the Internet -- either through a direct Ethernet connection or from a dial-up service with SLIP or PPP capabilities. MacTCP is included in System 7.5, but you need to do a custom install to get it. You may also get MacTCP from the book Internet Starter Kit for Macintosh by Adam Engst. This book is also an excellent resource for people new to the Internet and provides far more information on getting connected than I could ever include here.
What about OpenTransport?
OpenTransport is the new replacement for the aging MacTCP. It is included with
PCI-based Macintoshes and is also available in System 7.5.3 (System 7.5 Update 2.0). OpenTransport provides the same TCP/IP connectivity as MacTCP, but with a friendlier interface and much improved performance for PowerPC-based computers. WeatherTracker currently only supports OpenTransport in PowerPC native mode. (This is on the advice of Apple, which has stated that OpenTransport may not be compatible with 68K computers running MacOS 8.) WeatherTracker will still work on 68K Macs running OpenTransport, but the networking calls will be done in TCP Classic mode.
Getting Started
When WeatherTracker runs for the first time, it will attempt to connect to the weather server and retrieve current information for the default city, Washington, DC. You can cancel this process at any time by pressing command-period or the escape key. Registered users can define their own set of cities to view by choosing the City List menu item in the Edit menu. Add cities to the Current Cities list by selecting the appropriate country, state and city from the popup menus. When you are done, click the OK button.
Now you need to set the preferences by choosing the Preferences menu item in the Edit menu. Use the popup menu to select the City preferences panel. The Get Weather checkbox controls which cities actually get new information from the weather server. You may want to have five cities in your list, but only get current information on two of them, saving the others for special occasions. To reduce loads on the weather servers, please limit yourself to at most two active cities. When you are done setting preferences, click the OK button to save them.
To get new information immediately, choose the Force Update menu item in the Weather menu. Current weather conditions will be obtained for each of the active cities in your list. You should not need to use the Force Update command again since WeatherTracker automatically contacts the weather server every hour to request new information.
Features
The following is an explanation of the major features of WeatherTracker. Extensive Balloon Help is also available to give specific help on any area you desire.
The large analog window is your main display for city conditions:
╩
Double-clicking within the various panels will bring up the preferences window for the area of interest. If desktop space is scarce, you can view the data in a smaller "digital" window:
╩
For those who want the smallest possible window footprint, there is also a new "tiny" window:
╩
Cities are selected using the Add City item in the Edit menu. You may have as many cities selected as you want, limited only by the amount of memory allocated to WeatherTracker. There are separate preferences available for each city. In the City Preferences, click the Get Weather checkbox to select whether new reports are to be retreived for a particular city. The weather servers are already heavily loaded, so I ask that you only get information for at most two cities in your list of selected cities.
Every hour, WeatherTracker will contact the weather server and download the latest information for the selected cities. If a server is not responding, WeatherTracker will cycle through the list of servers from the Network Preferences until a working server is found. For cities in the United States and Canada, local forecasts are automatically downloaded with the current weather conditions. Forecasts are not available from the weather server for cities outside the United States and Canada.
Near shore marine forecasts are also available for selected cities in coastal areas of the United States. To retrieve marine forecasts, click the Get Marine Forecast checkbox in the City Preferences.
Climate data is available for many cities in the United States. To retrieve climate data, click the Get Climate Data checkbox in the City Selection Preferences card. The data that is reported varies greatly depending on the city. Some cities do not report climate data; others report daily temperatures and sunrise/sunset information; still others give detailed reports of the recent trends in the local weather.
The local forecast, marine forecast, and climate data call all be copied to the clipboard, saved as TeachText documents, or printed at any time.
Getting Help
Extensive balloon help is available to give brief descriptions of the various commands and their actions. This text is also accessible online by choosing the WeatherTracker Help item in the Balloon Help menu.
Using Other Servers
WeatherTracker is currently configured to work only on rainmaker.wunderground.com. It may also work on any of the following servers:
downwind.sprl.umich.edu
madlab.sprl.umich.edu
um-weather.sprl.umich.edu
Please note that these servers are no longer suitable for non-interactive users (such as WeatherTracker users). The server administrators will be randomly changing the interface in such as way as to cause any program that attemps to connect non-interactively to fail to retrieve data. This may have the side effect of causing WeatherTracker to crash or lock up as it looks for non-existant prompts. The rainmaker server will should be the only server that you need to use. I am not aware of any other servers currently in operation that give comparable data.
Firewall Users
Due to the limited scope of the telnet proxy hack that was in previous versions, firewall support has been removed for this version. I had planned to add support for SOCKS proxy, but time constraints prevented its inclusion. SOCKS will be included in the near future.
Version History
2.2.4 November 3, 1996
Ñ fixed crash on disconnect for 68K users
2.2.3 November 2, 1996
Ñ Kagi shareware payment system begun
Ñ fixed problems with some New York cities
Ñ updated to CodeWarrior 10
2.2.2 September 17, 1996
Ñ fixed problems with European data
2.2.1 August 29, 1996
Ñ unregistered users can get data for any city, but no automatic updates
Ñ unregistered users cannot save prefs on quit
Ñ fixed bug which cut off "M" in AM/PM in tiny window
Ñ fixed bug which caused city to be skipped if conditions were N/A
Ñ added networking classes 7/18/96 bug fix
2.2 July 4, 1996
Ñ All users can access rainmaker.wunderground.com, but only registered users can
change the list of cities to view.
2.1.8 June 12, 1996
Ñ TCP networking now works again. Curses to 2's Complement!
2.1.7 June 11, 1996
Ñ Fixed problems when retrieving multiple cities
Ñ Fixed problem with selections in text windows with multiple cities
Ñ Added sanity checks around parsing routines
2.1.6 June 5, 1996
Ñ Renamed MacWx
Ñ Updated to CodeWarrior 9
Ñ Fixed parsing for many cities in Alaska
Ñ Full text editing support is back in place
2.1.5 May 23, 1996
Ñ Increased speed when many fonts installed
2.1.4 April 27, 1996
Ñ Replaced text engine with standard TextEdit calls
Ñ Fixed several memory-related bugs
Ñ Added support for new port on rainmaker.wunderground.com
Ñ Added registration codes
Ñ Added preferences panel for font selection
2.1.3 April 11, 1996
Ñ Renamed NetWeather
Ñ Corrected problems with forecasts in the Dallas, TX area
Ñ Updated text engine to support word wrap.
Ñ Added lots of debugging checks around data retrieval and parsing routines.
2.1.2 March 28, 1996
Ñ Preferences file conversion removed. Still too many bugs
Ñ Use Logfile now works on PowerPCs
Ñ Min/max work correctly.
Ñ Get Marine and Get Climate now get the proper data.
Ñ Cities are no longer skipped if the time stamp is the same.
Ñ um-weather now connects on port 3001 instead of 3000.
Ñ Non-US/Canada cities now work
Ñ Data is updated after changing the city list
Ñ Wind chill is not calculated for speeds below 5 mph
2.1.1 March 25, 1996
Ñ Fixed a bug with drawing text in 68K version
2.1 March 25, 1996
Ñ Rewritten for PowerPlant
Ñ Newly styled windows
Ñ Support for multiple cities
Ñ Logging of data to files
Ñ Daily min/max for thermometer and barometer
Ñ Wind chill, heat index, and dewpoint
Ñ Time stamp supports Date & Time control panel settings
2.0.4 August 28, 1994
Ñ Many spelling corrections
Ñ Updated cities for newly supported major cities
Ñ Increased width of digital window slightly to accomodate longer conditions
Ñ MacWeather FAQ now included
2.0.3 August 4, 1994
Ñ Special release for Internet Starter Kit
Ñ Fixed a few typos
Ñ Window title now updated when starting a connection
2.0.2 July 25, 1994
Ñ Removed PowerPC native code -- lots more testing necessary
2.0.1 July 25, 1994
Ñ Fixed a bug which caused crashes when parsing forecasts
2.0 July 24, 1994
Ñ Added support for hPa and km/h
Ñ Added support for tons of new cities in the US and abroad
Ñ Added support for near-short marine forecasts in the US
Ñ Added support for climatic data in the US
Ñ Added nighttime icons
Ñ Added support for saving and printing forecasts
Ñ Added Recent menu to switch between cities easily
Ñ Added Default button for preferences
Ñ Added support for firewalls (still buggy)
Ñ Added units to wind speed display
Ñ Redrew displays to make them look a little better
Ñ Numerous minor bug fixes
1.1.1 March 8, 1994
Ñ Fixed a bug caused by the last bug fix when conditions hadn't changed
Ñ Fixed a bug with mouse clicks in the City Code edit field
1.1 March 7, 1994
Ñ Enabled copying from forecast window
Ñ Rewrote icon picking code -- hopefully it now recognizes most of them
Ñ Removed alert message for no icon available
Ñ Fixed a few bugs related to edit boxes in the prefs window
Ñ Added Location menu
Ñ Fixed a bug which caused the forecast to be erased when conditions hadn't changed
Ñ Added smaller digital display
1.0 February 27, 1994
Ñ First public release
To Do List
Ñ SOCKS support
Ñ Support for Apple Script
Ñ Support for Apple Guide
Ñ Option to put temperature (or whatever you want) in menu bar
Ñ Clean up of data presented in the various forecast windows
Shareware Notice
Shareware registration for WeatherTracker is now being handled through Kagi. To register, run the "Register" program included with this distribution. Fill in your home and email addresses. Type in the number of copies (US$15 each) you would like to register in the box next to "Single User". Site licenses and worldwide licenses are also available, but most users will not need those. Select your payment method and provide any additional information as requested. When you are done, print out the form and send it to:
Kagi Shareware
1442-A Walnut Street #392-HX
Berkeley, California, 94709-1405
USA
FAX: +1 510 652 6589
Online registration is also available for credit card and First Virtual accounts at:
<http://kagi.direct.net/cgi-bin/register1.cgi?HX>
Acknowledgements of payment are sent from Kagi when they are processed (usually within one week of receipt). When I am notified of your payment, I will send you a registration code via email. After you enter this code, WeatherTracker will save your preferences when you quit. If you do not get an acknowledgement from Kagi, you can contact them at <shareware@kagi.com>. Should you have any other problems with the registration process, feel free to contact me at <weathertracker@kagi.com>.
Current information can be found on the WeatherTracker home page at